home *** CD-ROM | disk | FTP | other *** search
/ MACup 1998 February / Image.iso / MACup Leser-CD 2⁄98 / MkLinux-Updates / DR2.1update6 / README.install < prev    next >
Text File  |  1997-12-07  |  15KB  |  386 lines
  1. November 12, 1997
  2.  
  3. This file describes how to install the individual pieces of the DR2.1update6
  4. MkLinux update.  These pieces are the Microkernel, the Linux Server and the
  5. Default Pager.
  6.  
  7. A true DR2.1update6 system also has several RPM (Redhat Package Manager)
  8. packages installed.  These packages were installed during updates 3
  9. and 4.  There are no new RPMs to install for this update, however you
  10. should have the RPMs up through update4.  In case you are not applying
  11. DR2.1update6 directly from DR2.1update5, there are some tips at the
  12. bottom of this file to help you skip updates when bringing your system
  13. up to a full "DR2.1update6" level.
  14.  
  15. How to install the Mach Kernel and Linux Server
  16. -----------------------------------------------
  17.  
  18. Before we go on, there is something that must be said:
  19. ** ALWAYS BE SURE TO MAKE BACKUP COPIES OF THE MACH KERNEL AND LINUX SERVER. **
  20. (especially if you already had MkLinux running, or even limping :-)
  21.  
  22. For the Mach Kernel, which normally lives in your Extensions folder, just
  23. rename the file.  For the Linux Server, vmlinux, be sure to leave a backup
  24. copy in the /mach_servers directory.  If something doesn't work right with
  25. the new kernel/server pair, you'll be able to go back to the old kernel
  26. (by renaming it back to "Mach Kernel" in your extensions folder), boot it
  27. and the previous vmlinux.  If you change your MkLinux Booter, you should
  28. also save a copy of your previous MkLinux Booter.
  29.  
  30.  
  31. Obtaining the kernel/server pair
  32. --------------------------------
  33.  
  34. The Mach Kernel and Linux Server can be ftp'ed from the MkLinux ftp site:
  35.     ftp://ftp.mklinux.apple.com/pub/Updates/DR2.1update6/
  36.  
  37. The Mach Kernel is gzipped (ie. compressed) and is called:
  38.     Mach_Kernel.gz
  39.  
  40. The Linux Server is also gzipped, and is called:
  41.     vmlinux.gz
  42.  
  43. These files should be available on various mirror sites as well.
  44.  
  45.  
  46. General downloading notes
  47. -------------------------
  48.  
  49. If you are using Mac OS to download files, make sure you set the format
  50. to BINARY for ftp'ing these files.
  51.  
  52. We recommend you use Fetch or similar FTP Mac OS application rather than
  53. Netscape or another Web Browser.  Some browsers are incorrectly configured,
  54. resulting in corrupted downloaded files.  Some browsers will attempt to
  55. display binary files such as the uncompressed Mach Kernel on the screen.
  56.  
  57. A copy of Fetch can be found in ftp://ftp.mklinux.apple.com/pub/FTP_tools
  58.  
  59.  
  60. The Mach Kernel
  61. ---------------
  62.  
  63. We provide a pre-built Mach Kernel in gzipped (compressed) form.  The
  64. file name on the ftp site is:
  65.     Mach_Kernel.gz
  66.  
  67. You will need to "gunzip" it (ie. uncompress it) before it is usable.
  68. Then, it must be placed in your Extensions folder, with the name:
  69.     Mach Kernel
  70.  
  71. Note, there's a space in that name, even though on the ftp site there
  72. is an underscore in the name.  Be sure to rename the file appropriately!
  73.  
  74. Note also that the gunzipped version will look like a simple document:
  75. no fancy icon, no special type or creator ID.  This is OK.  The Mach Kernel
  76. file is a document used by the MkLinux Booter.  It may not look pretty,
  77. but if it has the correct name (Mach Kernel), the right type (Document,
  78. NOT SimpleText Document) and is in the Extensions folder, the Booter will
  79. find it and launch MkLinux.
  80.  
  81. (see below for hints on how to gunzip files in both MacOS and MkLinux, and
  82. for hints on moving files between the Mac Filesystem and the MkLinux
  83. filesystem)
  84.  
  85.  
  86. The Linux Server
  87. ----------------
  88.  
  89. Like the kernel, we provide a pre-built Linux server in gzipped form.
  90. The file is:
  91.     vmlinux.gz
  92.  
  93. It too must be be gunzipped.  The linux server "lives" in your MkLinux
  94. filesystem, in the directory "/mach_servers".  Its name should be
  95.     /mach_servers/vmlinux
  96. when it's installed.  There is probably already a "vmlinux" file there,
  97. so you should probably rename the old one.
  98.  
  99. (see below for hints on how to gunzip files in both MacOS and MkLinux, and
  100. for hints on moving files between the Mac Filesystem and the MkLinux
  101. filesystem)
  102.  
  103.  
  104. The Default Pager
  105. -----------------
  106.  
  107. The Default Pager, like the Linux Server, is a mach task.  Follow the
  108. instructions for the Linux Server above, but the file is "default_pager.gz".
  109.  
  110.  
  111. The MkLinux Booter
  112. ------------------
  113.  
  114. (Note, update6 does not have a new booter.  However, if you are applying
  115.  this update from a version of MkLinux before update5, then you will need
  116.  the booter from update5.)
  117.  
  118. The MkLinux Booter is an extension that goes in your Extensions folder.
  119. We provide the MkLinux Booter in binhexed form.  The file is:
  120.     MkLinux_Booter.hqx
  121.  
  122. Most Mac-based FTP clients can un-binhex it for you after the file is
  123. retrieved.  There are a number of alternative methods of un-binhexing
  124. the file.  Once you have the MkLinux Booter, place the file in your
  125. Extensions Folder.  NOTE: the file must be named "MkLinux Booter" (with
  126. the space and without the quotes).
  127.  
  128. Version Information
  129. -------------------
  130.  
  131. The version of the Mach Kernel and Linux Server installed on the system
  132. may be obtained through two files located in the /proc filesystem. 
  133.  
  134. To see the version string for the Mach Kernel, type:
  135.     cat /proc/osfmach3/version
  136.  
  137. To see the version string for the Linux server, type:
  138.     cat /proc/version
  139.  
  140. The dates in these two version strings should match the date at the top
  141. of this message.
  142.  
  143.  
  144. How to gunzip (ie. uncompress) files
  145. ------------------------------------
  146.  
  147. If you are running MkLinux, there are a couple ways that you can uncompress
  148. a gzipped file.  For instance, if you have vmlinux.gz, and you want
  149. to uncompress it, use the command:
  150.     gunzip vmlinux.gz
  151.  
  152. As an alternative, you could keep the original ".gz" file and use
  153. the command:
  154.     zcat vmlinux.gz > /mach_servers/vmlinux
  155. (for instance)
  156.  
  157.  
  158. If you are running MacOS, get the tool MacGzip from the ftp site:
  159.     ftp://ftp.mklinux.apple.com/pub/FTP_tools
  160.  
  161. Drag a gzipped file (such as Mach_Kernel.gz) onto the MacGzip icon.
  162. MacGzip will recognize it as a gzipped file and uncompress it.
  163.  
  164. Whichever method you use to gunzip the file, if either program "complains"
  165. about corrupt files, you'll most likely need to FTP the file again.
  166.  
  167.  
  168. How to move files between the MkLinux filesystem and the Mac OS volume
  169. ----------------------------------------------------------------------
  170. The following steps are an example of how to transfer the Mach Kernel
  171. from a MkLinux filesystem to a Mac OS volume and how to transfer a
  172. Linux Server from the Mac OS volume to the MkLinux filesystem.
  173.  
  174. All steps are performed under MkLinux and as the user root.
  175.  
  176. 1) "mount" the HFS volume. You will need to know the SCSI ID and
  177.     partition number of the HFS volume where the file is located.
  178.     For example:
  179.     
  180.     hmount /dev/sda3
  181.     
  182.     This will mount SCSI ID 0 (a=0, b=1, c=2, etc), partition 3.
  183.     You can use the disklabel utility to determine which partion
  184.     is your HFS partition:
  185.     
  186.         disklabel /dev/sda
  187.  
  188. 2) Next, change directory to where the file exists, or is to be placed in,
  189.    the HFS volume.  In this example, the file is to be placed in the Extensions
  190.    folder in the System Folder.
  191.       
  192.    hcd ":System Folder:Extensions"
  193.    
  194.    Note, HFSUTILS uses ":", not "/" to separate names in a path.  For
  195.    example, if the file was located in a folder named "MkLinux Downloads"
  196.    within the folder "My Downloads", then the path would look like
  197.    ":My Downloads:MkLinux Downloads" 
  198.           
  199. 3) The last step actually copies the file.
  200.  
  201.    hcopy -r /tmp/Mach_Kernel ":Mach Kernel"
  202.    
  203.     This will copy the file /tmp/Mach_Kernel (note the underscore) to the
  204.     file "Mach Kernel" (note the space) in the Extensions directory in
  205.     the System Folder on the HFS volume.
  206.  
  207. 4) Or, to copy a file _from_ the HFS volume to MkLinux
  208.           
  209.    hcopy -r ":vmlinux.gz" /tmp/vmlinux.gz
  210.    
  211.    This will copy the vmlinux.gz file from the current location to
  212.    vmlinux in the /tmp directory in the MkLinux filesystem.
  213.    
  214. That's it! For more information, read the hfsutils manual page
  215. (man hfsutils)
  216.  
  217.  
  218. File transfer between MkLinux and the Mac OS volume when you can't run MkLinux
  219. ------------------------------------------------------------------------------
  220. ***
  221. *** NOTE: If you use Linux Disks, be sure to get a recent version!
  222. ***       Version 1.0d5 was known to corrupt the MkLinux filesystem
  223. ***
  224.  
  225. Sometimes, you may need to manipulate the MkLinux filesystem from MacOS.
  226. Although it's not likely that you would need to do this to apply this update,
  227. there is a way to move files to and from the MkLinux filesystem when you're
  228. running MacOS.
  229.  
  230. There is a utility called LinuxDisks written by Michel Pollet.  It is
  231. currently under active development, but is quite effective.  For more
  232. information on obtaining LinuxDisks, point your web browser to:
  233.     http://w3.teaser.fr/~mpollet/LinuxDisks/
  234.  
  235. Even though you probably won't need the tool for this update, it is very
  236. handy to have around.
  237.  
  238.  
  239. Problems after Installation
  240. ---------------------------
  241.  
  242. Some users have reported a new update will cause the system to be
  243. "stuck" at the MkLinux Boot splash screen -- the dialog box which
  244. asks if you want to continue to boot into Mac OS or boot into
  245. MkLinux.
  246.  
  247. Here are some suggestions on how to fix this problem -
  248.  
  249. * Verify the Mach Kernel was correctly downloaded. Web Browsers sometimes
  250.   have problems; we recommend you use Fetch. Be sure the BINARY transfer
  251.   mode was set.  Be sure the Kind is "document".
  252.   
  253. * Some 6100's with DOS cards are reported not to boot MkLinux with the
  254.   DOS card running. Try turning the card off. This can be done through its
  255.   control panel.
  256.   
  257. * Try lowering the Disk Cache size under Mac OS to 96KB or less.
  258.   This can be done through the Memory Control Panel. 
  259.   MkLinux booting has been sensitive to the memory usage of Mac OS.
  260.  
  261. * Verify the system is not running RAM Doubler or a similar product. 
  262.   Also, in some configurations, Speed Doubler has been known to
  263.   conflict with the booting process. 
  264.   
  265.  
  266. Reverting back to the previous Mach Kernel and Linux Server
  267. -----------------------------------------------------------
  268.  
  269. In case the new Mach Kernel and/or Linux server breaks more than it fixes,
  270. you can revert back to the previous version (assuming you have made backup
  271. copies).
  272.  
  273. Restoring the Mach Kernel file is easy; simply copy the backed up version
  274. to the Extensions folder - be sure the file is named "Mach Kernel" (note
  275. that there's a space in the name).
  276.  
  277. Restoring the Linux Server, vmlinux, requires a few more steps -
  278.  
  279. 1) Under Mac OS, edit the lilo.conf file to include the line
  280.          mach_options=-a
  281.  
  282.    The lilo.conf file can edited by clicking on the CUSTOM button
  283.    in the MkLinux control panel.
  284.  
  285.    If you already had a mach_options line (for other reasons), put the
  286.    "-a" at the beginning of the line, just after the "=" symbol.  Ie.
  287.     mach_options=-a -m90 video_probe=true bus_speed_hz=44000000
  288.  
  289.    As an alternative to adding "-a" to your mach_options, you can simply
  290.    press "a" on the "splash screen" (the one with the countdown) when you're
  291.    booting MkLinux.
  292.  
  293. 2) Reboot into MkLinux
  294.  
  295. 3) MkLinux should prompt you for a new bootstrap.conf file.
  296.    Simply press <RETURN>.
  297.  
  298. 4) You will be prompted for the default pager. Press <RETURN> again.
  299.  
  300. 5) At this point you should be prompted for vmlinux (Linux Server).
  301.    Here you can make corrections (i.e. use the DELETE key) to edit
  302.    the name to the backed up version of the Linux Server. Press <RETURN>
  303.    to continue booting.
  304.  
  305. 6) The system should boot with the older version.
  306.  
  307. Once the system is up, restore the old vmlinux file as "/mach_servers/vmlinux".
  308. Don't forget to restore the "mach_options" line in the lilo.conf file.
  309.  
  310.  
  311. Some Tips for Skipping Previous Updates
  312. ---------------------------------------
  313.  
  314. If your system isn't completely at DR2.1update5, and you want to bring
  315. it to the update6 level, do not worry.  You do not need to apply all
  316. the previous updates.  What you need to know is that a true DR2.1update6
  317. system has 3 pieces from the DR2.1update6 directory (the Mach Kernel, the
  318. Linux Server, and the Default Pager), the MkLinux Booter from the DR2.1update5
  319. directory, and many packages based on shared libraries from the DR2.1update4
  320. update.  In general, you want to get your system running with the new update6
  321. pieces and the update5 booter, then attend to bringing your shared libraries
  322. up to the DR2.1update4 level.
  323.  
  324. Here are some quick recipes for bringing systems to the DR2.1update6 level.
  325.  
  326. From a Fresh Install from DR2.1 CD or FTP install to DR2.1update6:
  327. ------------------------------------------------------------------
  328. - Partition your disk and run the DR2.1 installer as if you were simply
  329.   installing DR2.1.
  330. - When the installer (the MacOS application) completes, run the MkLinux
  331.   control panel at least once (so that the appropriate Preferences files
  332.   are put in place).
  333. - Obtain the MkLinux Booter from DR2.1update5.  Put it in Extensions folder.
  334. - Obtain the Mach Kernel from DR2.1update6.  Put it in Extensions folder.
  335. - Boot into MkLinux.
  336. - Obtain the vmlinux and default_pager from DR2.1update6 and place them in
  337.   your /mach_servers directory.
  338. - Reboot.
  339. - Follow the "alternate second half of the DR2.1update4" installation --
  340.   the shared libraries.  This involves getting the RPMs from the Alternates
  341.   directory in the DR2.1update4 directory and the install_shlibs.u2u4 script.
  342.   Execute install_shlibs.u2u4 and perform the "forcible reboot".
  343.  
  344. From a DR2.1, DR2.1update1, or DR2.1update2 system to DR2.1update6:
  345. -------------------------------------------------------------------
  346. - Obtain the MkLinux Booter from DR2.1update5.  Put it in Extensions folder.
  347. - Obtain the Mach Kernel from DR2.1update6.  Put it in Extensions folder.
  348. - Boot into MkLinux.
  349. - Obtain the vmlinux and default_pager from DR2.1update6 and place them in
  350.   your /mach_servers directory.
  351. - Reboot.
  352. - Follow the "alternate second half of the DR2.1update4" installation --
  353.   the shared libraries.  This involves getting the RPMs from the Alternates
  354.   directory in the DR2.1update4 directory and the install_shlibs.u2u4 script.
  355.   Execute install_shlibs.u2u4 and perform the "forcible reboot".
  356.  
  357. From a DR2.1update3 system to DR2.1update6:
  358. -------------------------------------------
  359. - Obtain the MkLinux Booter from DR2.1update5.  Put it in Extensions folder.
  360. - Obtain the Mach Kernel from DR2.1update6.  Put it in Extensions folder.
  361. - Boot into MkLinux.
  362. - Obtain the vmlinux and default_pager from DR2.1update6 and place them in
  363.   your /mach_servers directory.
  364. - Reboot.
  365. - Follow the regular "second half of the DR2.1update4" installation --
  366.   the shared libraries.  This involves getting the RPMs from the DR2.1update4
  367.   directory and the install_shlibs.u3u4 script.
  368.   Execute install_shlibs.u3u4 and perform the "forcible reboot".
  369.  
  370. From a DR2.1update4 system to DR2.1update6:
  371. -------------------------------------------
  372. - Obtain the MkLinux Booter from DR2.1update5.  Put it in Extensions folder.
  373. - Obtain the Mach Kernel from DR2.1update6.  Put it in Extensions folder.
  374. - Boot into MkLinux.
  375. - Obtain the vmlinux and default_pager from DR2.1update6 and place them in
  376.   your /mach_servers directory.
  377. - Reboot.
  378.  
  379. From a DR2.1update5 system to DR2.1update6:
  380. -------------------------------------------
  381. - Obtain the Mach Kernel from DR2.1update6.  Put it in Extensions folder.
  382. - Boot into MkLinux.
  383. - Obtain the vmlinux and default_pager from DR2.1update6 and place them in
  384.   your /mach_servers directory.
  385. - Reboot.
  386.